Routines (alphabetical) > Routines: H > HDF-EOS Routines > EOS_GD_WRITEATTR

EOS_GD_WRITEATTR

This function writes/updates attributes in the grid. If the attribute does not exist, it is created. If it does exist, then the value(s) is (are) updated.

Syntax

Result = EOS_GD_WRITEATTR( gridID, attrname, datbuf [, COUNT=value] [, HDF_TYPE=value] )

Return Value

Returns SUCCEED(0) if successful and FAIL(–1) otherwise.

Arguments

gridID

Grid id (long) returned by EOS_GD_CREATE or EOS_GD_ATTACH.

attrname

Attribute name (string).

datbuf

Attribute values. If HDF_TYPE is specified, the IDL variable is first converted to the type specified by the keyword before being written.

Keywords

COUNT

Number of values to store in attribute (long).

HDF_TYPE

HDF data type of attribute (long).

Examples

In this example. we write a single precision (32 bit) floating point number with the name “ScalarFloat” and the value 3.14:

f32 = 3.14

status = EOS_GD_WRITEATTR(gridid, "ScalarFloat", f32)

We can update this value by simply calling the function again with the new value:

f32 = 3.14159

status = EOS_GD_WRITEATTR(gridid, "ScalarFloat", f32)

Version History

5.2	Introduced